Inside Macintosh: QuickDraw GX Printing /

Chapter 3 - Page Formatting and Dialog Box Customization / Page Formatting and Dialog Box Customization Reference

Application-Defined Functions / Message Override Functions for Customizing QuickDraw GX Dialog Boxes

GXFilterPanelEvent

QuickDraw GX sends the gxFilterPanelEvent message when an event happens in a panel. You can install an override function for the gxFilterPanelEvent message to add panels that need a filter procedure. Your override function must match the following formal declaration:

OSErr GXFilterPanelEvent (gxPanelInfoRecord *aPanelInfoRecord; 
                        Boolean *returnImmed);

aPanelInfoRecord

A pointer to the panel information structure that supplies information to the panel about the current dialog box and panel event.

returnImmed

On return, a Boolean value that is true if there should be no further processing on this event and false if not.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends the gxFilterPanelEvent message to filter panel events in a dialog box.

The default implementation of this message does nothing. You need to override this message if you add panels that require a filtering process.

SPECIAL CONSIDERATIONS

You never send the gxFilterPanelEvent message yourself.

You always perform a total override of the gxFilterPanelEvent message, in which you filter any events that occur in your panel.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help